Events Homepage
- iPad
Events Management has a timeline-based homepage that enables users to quickly locate appropriate events in the past, currently open events, or events planned in the future. Additionally, users can extensively filter and search for event information, for example, accounts, speakers, or topics available to the user. The events homepage also uses a series of icons to represent various event statuses, enabling users to visually identify an event’s lifecycle state.
This enhanced UI will completely replace the existing homepage in a future release.
For example, Sarah Jones wants to continue working on an approved, upcoming speaker event later this month. She navigates to the Events Management tab in CRM and filters the list of events to only display upcoming events owned by her. She searches for the event’s speaker, quickly locates her event, and resumes preparing for the event.
Considerations
- This feature is only available to Events Management users, not Medical Events users. However, if users are configured to use both Events Management and Medical Events, available Medical Events also display in this tab alongside Events Management events.
Prerequisites
- Ensure Events Management is configured for all appropriate users
Configuring the Events Timeline Homepage
To configure this feature, complete the steps in all of the following configuration sections.
Admins
To configure this feature for admins:
- Populate the Enhanced_Interface_Mode_vod Events Management Setting with a value of 1.
-
Grant admins the following permissions:
Object
OLS
Record Types
Fields
FLS
EM_Event_vod CRUD n/a Event_Identifier_vod
Edit Event_Attendee_vod
CRUD
n/a
- EM_Speaker_vod
- EM_Speaker_Identifier_vod
Edit
Medical_Event_vod
CRUD
n/a
- Event_Identifier_vod
- Is_Parent_vod
- Product_vod
- Program_Type_vod
- Event_Format_vod
- Topic_Name_vod
Edit
End Users
To configure this feature for end users:
- Populate the Enhanced_Interface_Mode_vod Events Management Setting with a value of 1.
-
Grant admins and organizers the following permissions:
Object
OLS
Record Types
Fields
FLS
EM_Event_vod CRUD n/a - Event_Format_vod
- Event_Identifier_vod
Edit Event_Attendee_vod
CRU
n/a
- EM_Speaker_vod
- EM_Speaker_Identifier_vod
Read
Medical_Event_vod
CRU
n/a
- Event_Identifier_vod
- Is_Parent_vod
- Product_vod
- Program_Type_vod
- Event_Format_vod
- Topic_Name_vod
Read
Mapping Icons to Event Statuses
The events homepage uses a series of icons to represent various event statuses, enabling users to visually identify an event’s lifecycle state. Admins can map these icons to the appropriate event statuses by editing the STATUS_ICON_MAP_vod Events Management Setting with the following format:
<Icon Name1>:<Status 1>,<Status2>;<Icon Name 2>:<Status 1>
The following icons are available:
Icon |
Icon Name |
Default Assigned Statuses |
---|---|---|
|
Requested_vod |
|
|
Pending_Approval_vod |
Pending_Approval_vod |
|
Approved_vod |
Approved_vod |
|
Rejected_vod |
Rejected_vod |
|
Pending_Action_vod |
None |
|
Closed_vod |
|
For example:
Requested_vod:Draft_vod,Requested_vod;Pending_Approval_vod:Pending_Manager_Approval,Pending_Confirmation
If the text of the mapping exceeds the maximum length of the Events Management Setting, enter the full text in the Status_Icon_Map_vod Veeva Message and populate the Events Management Setting with the name of the Veeva Message instead.
Using the Events Homepage
To display the events homepage, navigate to the Events Management tab in CRM.
When the tab loads, any updates to event data are downloaded to the device if users have an active internet connection. Users can refresh retrieved data by pulling to refresh on the homepage.
A timestamp of the most recent update displays below the view name.
Events display as cards in a timeline, enabling organizers to quickly view information about an event’s details, as well as when it is scheduled in relation to other events. Organizers can view an event’s detail record page by selecting the appropriate card.
If the Local Time and Timezone feature is enabled alongside this feature, all displayed dates and times on the homepage also display the local event time.
Filtering and Searching the List of Events
A variety of filtering methods are available to organizers enabling them to quickly filter the greater list of events to only display the ones relevant to them.
-
List Views – The Events Management tab contains the following available list views:
- All Events
- Events I Own – Displays all events owned by the user
- Events I’m Attending – Displays all events where the user is a listed attendee or an Event Team Member. If Displaying Events in My Schedule for Event Team Members is enabled, events where the user is part of a group listed as an Event Team Member also display.
- Host Events – Displays all parent events not owned by the current user
Switching views clears any defined search terms and applied filters.
- Tabs – The following tabs are available grouping events based on their Start Date and End Date:
- Upcoming
- Past
-
Filters – The Filter button enables organizers to filter the list of events based on any of the following criteria. Users must have FLS read permission to the relevant fields for certain options to display:
- Date – Always available
- Status – Always available
- Account – Filters based on the Account_vod field on the EM_Event_vod and Medical_Event_vod objects
- Product – Filters based on the Product_vod field on the EM_Event_vod and Medical_Event_vod objects
-
Speaker – Filters based on the EM_Speaker_vod and EM_Event_Speaker_vod fields on the Event_Attendee_vod object
EM_Event_Speaker_vod records with a Status_vod of Rejected_vod do not display as available for selection.
All filters display as multi-select picklists, except for the Date filter, which displays as a calendar organizers can use to select a range for an event’s start date.
Additionally, the Account, Product, and Speaker multi-select picklists dynamically display values based on the current list of events. For example, Sarah Jones covers Cholecap and Restolar. There are no current events scheduled discussing Restolar, so when she filters by Product, only Cholecap displays as an available option.
-
Search Bar – Searching allows organizers to search for any information on an event’s card on the timeline. Matches to search terms highlight in the resulting event cards.
Displaying the Event Identifier on the Events Homepage
To enable event team members to quickly identify events on the Events Homepage, admins can configure an additional field used to search for an event. Organizations can populate this field via an automated process, for example an integration, to display identifying information to event team members.
To enable the Event Identifier, grant admins and end users FLS edit permission to the Event_Identifier_vod field on the following objects:
- EM_Event_vod
- Medical_Event_vod
Customers are responsible for defining and populating the Event_Identifier_vod field. The field can be populated by any means, for example, manually, an integration, or via data-loading.
When the Event_Identifier_vod field is populated, it displays on the Events Homepage on each event card in the timeline beneath the event’s record type and Program_Type_vod field.
End users can search on the Event_Identifier_vod field. Matches to search terms highlight in the resulting event cards.